Access Integration Services Using and Configuring Features Version 3.3
This chapter describes DIALs configuration and operational commands.
The chapter includes:
Use the following procedure to access the global configuration
process.
- At the OPCON prompt, enter talk 6.
(For more detail on this command, refer to The
OPCON Process and Commands in the Access Integration Services Software User's Guide.) For
example:
* talk 6
Config>
After you enter the talk 6 command, the CONFIG prompt
(Config>) displays on the terminal. If the prompt does
not appear when you first enter configuration, press Return
again.
- At the CONFIG prompt, enter the feature dials command
to get to the DIALs Config> prompt and access the DIALs global
parameter configuration environment.
Table 54. DIALs Global Configuration Commands
Command
| Function
|
? (Help)
| Displays all the commands available for this command level or lists the
options for specific commands (if available). See "Getting Help".
|
Add
| Adds a (Dynamic Host Configuration Protocol) DHCP server to the list of
DHCP servers or adds an IP address pool.
|
Delete
| Deletes a DHCP server from the list or removes a block of addresses from
an IP address pool
|
Disable
| Disables IP address assignment methods, dial-out protocols, multi-chassis
MP, SPAP Banner, and Dynamic DNS.
|
Enable
| Enables various methods of IP address assignments, dial-out protocols,
multi-chassis MP, SPAP Banner, and Dynamic DNS.
|
List
| Lists the Global DIALs parameters and their values.
|
Set
| Sets time-allowed, dhcp gateway address, NetBIOS Name Server addresses,
locally assigned MAC addresses, Virtual Connections (VC) Dynamic Name Server
addresses, dial-out inactivity timer, and dial-out server-name.
|
Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the add command to add a new Proxy DHCP server to a list
of servers or to add an IP pool of addresses.
The proxy DHCP server list contains the IP addresses of the DHCP servers
that will, in turn, lease IP addresses to the dial-in clients. Multiple
servers may be added for redundancy. The maximum number of servers is
20.
The IP address pool feature provides a method by which the router may
retrieve an IP address from a locally defined pool of addresses to a dial-in
client. The client may use this address for the duration of the
connection to the router. A pool consists of one or more blocks of IP
addresses. The maximum number of blocks is 20. Each of these
blocks is defined by a base IP address and the number of addresses in the
block. The addresses in each block are ascending and contiguous,
starting with the base address.
Syntax:
- add
- dhcp-server ipaddress
-
- ip-pool baseaddress #addresses
- dhcp-server ipaddress
- Adds a dhcp-server with the specified IP address.
Example :
DIALs Config> add dhcp-server
DIALs Proxy DHCP server address [0.0.0.0]? 10.0.0.1
- ip-pool baseaddress #addresses
- Add a block of addresses to the IP pool.
Example:
DIALs Config> add ip-pool
Base address []? 192.1.100.18
Number of addresses [1]? 57
DIALs config>add ip-pool
Base address []? 192.2.200.1
Number of addresses [1]? 250
DIALs config>list ip-pools
Configured IP address pools:
Base Address Last Address Number
------------ ------------ ------
192.1.100.18 192.1.100.74 57
192.2.200.1 192.2.200.250 250
Use the delete command to delete an existing Proxy DHCP
server from the list of servers or to remove a block of addresses from the IP
address pool.
Syntax:
- delete
- dhcp-server ip address
-
- ip-pool baseaddress #addresses
- dhcp-server ipaddress
- Removes a dhcp-server with the specified IP address.
Example:
DIALs Config> delete dhcp-server
Enter the address to be deleted [0.0.0.0]? 10.0.0.1
- ip-pool baseaddress #addresses
- Removes a block of addresses from the IP pool.
Example:
DIALs Config> delete ip-pool
Base IP address of the block to be removed []? 192.2.200.1
Use the disable command to disable an IP address assignment
method, dial-out protocols, SPAP Banner, and Dynamic DNS.
Syntax:
- disable
- dynamic-dns
-
- dial-out
-
- ip-address-assignment type
-
- spap-banner
- dial-out type
- Disables the use of dial-out with either telnet or IBM DIALs Dial-Out
clients. You can specify:
- dials
- Disables all IBM DIALs Dial-Out clients
- telnet
- Disables all telnet clients.
To disable both types of clients you must enter the disable dial-out
command for each type. Disabling both types of clients disables
dial-out on the 2212.
- dynamic-dns
- Disables the sending of DHCP option 81 for the user's hostname.
See "Dynamic Domain Name Server (DDNS)" for more information.
- IP-address-assignment type
- Disables various IPCP address assignment techniques. You may
specify any of the following:
- Client - Prevents client-assigned IP address assignment.
- Userid - Prevents using the authenticated user profile for an IP
address.
- Interface - Prevents the router from using the IPCP settings for the
interface.
- Pool - Prevents the router from using the IP address pool to assign
addresses to clients.
- DHCP-proxy - Prevents the router from leasing an address from the
DHCP server.
See "Server Provided IP Addresses" for additional information about assignment techniques.
- spap-banner
- Disables the sending of a SPAP banner to a remote user authenticated with
SPAP.
Note: | Entering a \n will force a new line character in the banner displayed
at the client.
|
Use the enable command to enable IP address assignment,
dial-out protocols, SPAP Banner, and Dynamic DNS.
Syntax:
- enable
- dynamic-dns
-
- ip-address-assignment . . .
-
- spap-banner
- dial-out type
- Enables the use of dial-out with either telnet or IBM DIALs Dial-Out
clients. By default, both types of clients are enabled. You can
specify:
- dials
- Enables all IBM DIALs Dial-Out clients
- telnet
- Enables all telnet clients.
- dynamic-dns
- Disables sending of DHCP option 81 for the user's hostname. See
"Dynamic Domain Name Server (DDNS)" for more information.
- IP-address-assignment type
- Enables various IPCP address assignment techniques. The router will
attempt each method enabled in the order listed. You may specify any of
the following:
- Client - Allows the client to specify the address it wants to
use.
- Userid - The router will look in the authenticated PPP user profile
for an IP address. If the address is nonzero, it will be offered to the
client.
- Interface - The router will look at the IP address configured on the
interface. If the address is nonzero, it will be offered to the
client.
- Pool - The router will request an address from the IP address
pool. If an address is available, it will be offered to the
client.
- DHCP-proxy - The router will attempt to lease an address from
DHCP. If successful, the address will be offered to the client.
See "Server Provided IP Addresses" for additional information about assignment techniques.
- spap-banner
- Enables the sending of a SPAP banner to a remote user authenticated with
SPAP. Use the set spap-banner command described on "Set" to enter the text of the SPAP banner. Refer to "Shiva Password Authentication Protocol
(SPAP)" in the Access Integration Services Software User's Guide for more information.
Use the list command to display the current
configuration. The DHCP state and lease times can be monitored for each
net from the Point-to-Point console. See the listipcp command in the Access Integration Services Software User's Guide for an example.
Syntax:
- list
- all
-
- dhcp-servers
-
- dial out
-
- dynamic-dns
-
- ip-address-assignment
-
- ip-pools
-
- name-servers
-
- spap-banner
-
- time-allowed
-
- vc-parameters
Example:
DIALs config>li all
DIALs client IP address assignment:
Client : Enabled
UserID : Enabled
Interface : Enabled
Pool : Enabled
DHCP Proxy : Disabled
Configured IP address pools:
Base Address Last Address Number
------------ ------------ ------
11.0.0.100 11.0.0.129 30
11.0.0.210 11.0.0.229 20
Configured DHCP servers: 11.0.0.2 11.0.0.50
Proxy DHCP is currently disabled
DHCP gateway address (giaddr): 11.0.0.10
Dynamic DNS: Enabled
Primary Domain Name Server (DNS): 11.0.0.2
Secondary Domain Name Server (DNS): None
Primary NetBIOS Name Server (NBNS): 11.0.0.2
Secondary NetBIOS Name Server (NBNS): None
Time allowed for connections: Unlimited
SPAP banner :Enabled
Welcome to the network...
Box-level dial-out settings
Inactive timer: 15
LAN Protocols enabled for dial-out: TELNET DIALs
Server name: DIALOUT_SERVER
Number of Mac Addresses defined = 0
Base MAC Address: 000000000000
VC: Maximum Virtual Connections = 50
VC: Maximum suspend time (hours) (0 is unlimited) = 12
VC: Idle timeout period (seconds) = 30
Multi-chassis MP: Endpoint discriminator (0 means use box s/n) = 0
DIALs config>
The example shows the following:
- DIALs client IP address specification
- Displays the IP address assignment techniques and whether they are
enabled. You would receive this section of the display and the section
containing the box-level dial-out settings in response to the list
ip-address-assignment command.
- IP address pools
- Displays the configured IP address pools. You would receive this
section of the display in response to the list ip-pool
command.
- Configured DHCP servers
- Displays the list of IP addresses currently configured as DHCP
servers. This section also lists the interface being used for the DHCP
gateway. You would receive this section of the display in response to
the list dhcp-servers command.
- Dynamic Name Servers
- Displays whether Dynamic DNS is enabled. You would receive this
section of the display in response to the list dynamic-dns
command.
- primary domain server (dns)
- This line and the following lines display the configured primary and
secondary name servers. You would receive this section of the display
in response to the list name-servers command.
- time allowed
- Displays the maximum amount of time (in minutes) for dials users.
You would receive this section of the display in response to the list
time-allowed command.
- spap banner
- Displays the contents of the spap banner. You would receive this
section of the display in response to the list spap-banner
command.
- vc connections
- Displays information about configured virtual connections.
- multi-chassis mp
- Displays the configured endpoint discriminator.
Use the set command to set the time-allowed,
dhcp gateway address, NetBIOS Name Server addresses, Dynamic Name Server
addresses and dial-out inactivity timer , and dial-out server-name.
Syntax:
- set
- dhcp-gateway-address
-
- dial-out . . .
-
- dns . . .
-
- laa
-
- multi-chassis-mp
-
- nbns . . .
-
- spap-banner . . .
-
- time-allowed
-
- vc-parameters
- dhcp-gateway-address interface# ipaddress
- Sets the IP address associated with the DHCP gateway. DHCP uses the
address as:
- An address to which DHCP replies
- An indication of the pool of addresses from which DHCP allocates an IP
address
If the DHCP server is not on a directly attached LAN interface, then you
must configure this address to the address of one of the LAN interfaces that
has IP connectivity to the DHCP server. See "Dynamic Host Configuration Protocol (DHCP)" and the definition of "giaddr" in RFC 1541 for more
information.
- dial-out parameter
- Sets the inactivity timer or server name for dial-out nets.
Parameter can be:
- inactivity-timer
- Sets the dial-out inactivity timer for dial-out nets. This is
defined as the amount of time, in minutes, that a user can be connected
without data traffic over the connection. For example, if the
inactivity-timer is set to 5 minutes and during any 5 minute interval, no data
is received or transmitted, the connection will be dropped and the modem will
become available. The default is 0, which means that the inactivity
timer is disabled and the connection will be maintained indefinitely.
- servername
- Sets the name of the dial-out server. This can be any string up to
30 characters in length. The default is
"2210_DIALS_SERVER". This is the name that the IBM DIALs Dial-Out
clients see when they use the "Chooser" application to discover dial-out
servers. This parameter has no meaning for telnet dial-out
clients.
- dns type ipaddress
- Configures the primary and secondary domain name servers (DNS).
Type can be:
- primary
- Sets the IP address of the primary DNS server for the dial-in client to
use. This value is negotiated during IPCP for some dial-up clients
(particularly Windows 95).
- secondary
- Sets the IP address of the secondary DNS server for the dial-in client to
use. This value is negotiated during IPCP for some dial-up clients
(particularly Windows 95).
- laa #MAC_addresses MAC_address_base
- Sets the number of MAC addresses and the base address for the Locally
Administered Address (LAA) table. Only Layer-2-Tunneling nets will use
LAA addresses.
- #MAC_addresses
- Specifies the number of Mac addresses to add to the LAA table, beginning
with the MAC_Address_Base.
Valid values: 0 to 256
Default value: 0
- MAC_address_base
- Specifies the base MAC address of the LAA table.
Valid values: Any valid MAC address
Default value: 000000000000
Example:
DIALs config>set laa
Number of Mac Addresses: [0]? 20
Locally Administered Mac Address Base (hex) [000000000000]? 002210aaaaaa
DIALs Config>
- multi-chassis-mp
- Sets the endpoint discriminator to be used. All links that are to
join the same bundle must have the same endpoint discriminator.
Example:
DIALs Config> set multi-chassis-mp
Enter Endpoint Discriminator to use from stacked group (0 for box S/N): 2345
- nbns type ipaddress
- Configures the primary and secondary NetBIOS name servers.
Type can be:
- primary
- Sets the IP address of the primary NetBIOS name server.
- secondary
- Sets the IP address of the secondary NetBIOS name server.
- spap-banner
- Allows configuration of a message that is sent out to all clients that
successfully complete SPAP authentication.
Example:
DIALs config>set spap-banner
SPAP banner :Disabled
Enter Banner: Welcome to the network...
- time-allowed
- Sets the time allowed for PPP dial-in users and dial-out users.
This parameter defines the maximum amount of time (in minutes) that a user can
be connected. The default value is 0, which means the user can be
connected for an unlimited amount of time.
- vc-parameters
- Use this parameter to set the global default virtual connection
attributes. The system prompts you for the maximum number of
connections, the maximum suspend time, and the inactivity timeout
value.
Example:
Config> feature DIALs
DIALs Config> set vc-parameters
Maximum Virtual Connections [50]? 40
Maximum suspended time (hours) (0 is unlimited) [10]? 18
Inactivity Timeout (seconds) [30]? 60
DIALs Config>
- Maximum Virtual Connections
- The maximum number of virtual connections that can be active or
suspended. When using VCs with MP, configure this value to be 1 greater
than the number of physical connections.
Valid values: 0 to 255
Default value: 50
- Maximum suspended time
- The maximum amount of time, in hours, a virtual connection can be
suspended before the system ends the connection. Specifying 0 for this
parameter allows a virtual connection to be suspended indefinitely.
Valid values: 0 to 48
Default value: 12
- Inactivity Timeout
- The number of seconds that a virtual connection can be inactive before it
is suspended.
Valid values: 10 to 1024
Default value: 30
Use the following procedure to access the DIALs monitoring commands.
- At the OPCON prompt, enter talk 5.
(For details on this command, see the chapter "The OPCON Process and Commands" in Access Integration Services Software User's Guide.) For example:
* talk 5
+
After you enter the talk 5 command, the GWCON prompt
(+) displays on the terminal. If the prompt does not appear
when you first enter configuration, press Return again.
- At the + prompt, enter the feature dials command to get you to
the DIALS Console> prompt and access the global monitoring
environment.
Example:
+ feature dials
DIALS Console>
Table 55. DIALs Global Monitoring Commands
Command
| Function
|
Clear
| Clears a specific suspended virtual connection.
|
List
| Displays the state of various virtual connections, or all virtual
connections.
|
Reset
| Dynamically activates DIALS parameters.
|
Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the clear command to clear specific suspended virtual
connections.
Syntax:
- clear
- vc connection_id
- vc connection_id
- Specifies the suspended virtual connection that you are ending. To
obtain the connection_id, enter either the list all-vc
or list suspended-vcs command.
Use the list command to display all virtual connections,
active virtual connections, suspended virtual connections, or the values of
the vc-parameters.
Syntax:
- list
- all
-
- active-vcs
-
- all-vcs
-
- dhcp-servers
-
- ip-address-assignment
-
- ip-pool
-
- suspended-vcs
- active-vcs
- Displays the attributes of all active virtual connections. See
description of the all-vcs parameter for an explanation of the
attributes.
- all-vcs
- Displays the attributes of all active and suspended virtual
connections. This display is a combination of the displays for the
list active-vcs and list suspended-vcs commands.
Example:
+ feature dials
DIALS console> list all
DIALs client IP address assignment:
Client : Enabled
UserID : Enabled
Interface : Enabled
Pool : Enabled
DHCP Proxy : Disabled
Current IP address pools:
Base Address Last Address Total Free
------------ ------------ ----- ----
* 11.0.0.100 11.0.0.129 30 30
11.0.0.210 11.0.0.229 20 19
Current DHCP servers: 11.0.0.2 11.0.0.50
Proxy DHCP is currently disabled
DHCP gateway address (giaddr): 11.0.0.10
Active VCs:
Conn ID Interface Idle-Timeout Connected Username
========== ========= ============ HHH:MM:SS ================
1656494850 8 30 0:26:15 don
7293521502 9 30 1:41:57 jane
Suspended VCs:
Hrs.Max
Conn ID Suspend Suspended Username
========== ======= HH:MM:SS ======================
9256166098 12 0: 4:13 joe
The attributes for active and suspended VCs are:
- Conn ID
- The connection id of the virtual connection. The system assigns the
id when it establishes the connection.
- Username
- The AAA. RADIUS, or local-list user that establishes the virtual
connection.
For active VCs:
- Interface
- The network interface that is managing the virtual connection.
Note: | Do not assign IP addresses to dial-up clients using interface assignment to
avoid problems caused by other users using this interface which the VC
suspended.
|
- Idle Timeout
- The amount of inactive time, in seconds, after which the system will
suspend the VC. This corresponds to the value of inactivity timer in
the set command.
- Connected HHH:MM:SS
- The total amount of time in hours, minutes, and seconds, that the VC has
been connected to an interface.
For suspended VCs:
- Hrs. Max Suspended
- The maximum number of hours a VC can be in suspend state before the system
ends the connection. This corresponds to the value of maximum suspended
time in the set command.
- Suspended HH:MM:SS
- The total amount of time in hours, minutes, and seconds, that the VC has
been suspended.
- dhcp-servers
- Displays configured information about DHCP servers and their IP
addresses.
- ip-address-assignment
- Display the methods by which IP addresses can be assigned to clients
- ip-pool
- Display the current usage of the pool.
Example:
DIALs Console> list ip-pool
Current IP address pools:
Base Address Last Address Total Free
------------ ------------ ----- ----
* 192.1.100.18 192.1.100.74 57 57
192.2.200.1 192.2.200.250 250 250
Note: The * indicates from which block the next address will be retrieved.
- suspended-vcs
- Displays the attributes of all suspended virtual connections. See
description of the all-vcs parameter for an explanation of the
attributes.
- vc-parameters
- Displays the values of the vc-parameters that were set using the set
vc-parameters command.
Use the reset command to dynamically activate the
configuration changes made to the DIALs interface in talk 6.
Syntax:
- reset
- all
-
- dhcp-parameters
-
- ip-address-assignment
-
- ip-pool
-
- vc-parameters
- all
- Dynamically activate the DHCP, IP address assignment, and IP-pool
configuration changes.
- dhcp-parameters
- Dynamically activate the DHCP configuration.
- ip-address-assignment
- Dynamically activate the IP address assignment method
configuration.
- ip-pool
- Dynamically activate the IP address pool configuration.
- vc-parameters
- Dynamically updates VC config changes.
To access the dial-out interface parameter environment:
- Enter talk 6 at the * prompt.
- Enter net n at the Config >
prompt.
- Enter encapsulator at the Circuit config: n>
prompt.
Table 56 lists the commands available from the dial-out
config> prompt.
Table 56. Dial-Out Interface Configuration Commands
Command
| Function
|
? (Help)
| Displays all the commands available for this command level or lists the
options for specific commands (if available). See "Getting Help".
|
Set
| Defines the port name associated with a modem.
|
Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the set command to define the port name for a
modem.
Syntax:
- set
- portname name
- portname
- Defines the name of the port associated with a modem. Use this name
to define modem pools. The name can be up to 30 characters
in length.
Default value: ALL_PORTS
Example: dial-out config>set portname
localcalls
Monitoring dial-in interfaces is the same as monitoring other PPP dial
circuits. For details, see "Configuring
and Monitoring Point-to-Point Protocol Interfaces" in the Access Integration Services Software User's Guide
.
Table 57 lists the commands available when monitoring dial-out
interfaces.
Table 57. Dial-Out Interface Monitoring Commands
Command
| Function
|
? (Help)
| Displays all the commands available for this command level or lists the
options for specific commands (if available). See "Getting Help".
|
Clear
| Resets the statistics for this dial-out interface.
|
List
| Lists the current state of the dial-out interface, the number of bytes
transmitted and received on this interface, and the client's current
parameters.
|
Exit
| Returns you to the previous command level. See "Exiting a Lower Level Environment".
|
Use the clear command to reset the statistics for the number
of octets received and transmitted by this interface.
Syntax:
- clear
-
Example:
clear
Statistics reset.
Use the list command to display current state of the
dial-out interface. The list command always displays the
current state of the dial-out net, the time since the state change, and the
number of bytes received and transmitted.
Syntax:
- list
-
Example for inactive interface:
list
Dial-out Settings for current session:
Dial-out state is DOWN
Time since change = 52 minutes and 34 seconds
Dial-out Octets transmitted = 0
Dial-out Octets received = 0
Session down, no valid settings
Note: | When a client connects to a dial-out port using telnet, no user name is
present because the server did not perform any authentication.
|
Example for active interface:
list
Dial-out Settings for current session:
Dial-out state is UP
Time since change = 3 seconds
Dial-out Octets transmitted = 14
Dial-out Octets received = 765
Current user = not available
Time allowed for user = unlimited
Inactivity timer for port = 10 minutes
Line speed = 57600
Current DTR state = DTR ON
Current dial-out protocol = TELNET
Options negotiated:
Will Suppress Go Ahead
Wont' Echo characters
Example for an active IBM DIALs Dial-Out client:
list
Dial-out Settings for current session:
Dial-out state is UP
Time since change = 12 seconds
Dial-out Octets transmitted = 11
Dial-out Octets received = 756
Current user = ebooth
Time allowed for user = unlimited
Inactivity timer for port = 10 minutes
Line speed = 57600
Current DTR state = DTR ON
Current dial-out protocol = DIALs
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]